<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta http-equiv="X-UA-Compatible" content="IE=edge">
  <meta name="viewport" content="width=device-width, height=device-height, initial-scale=1, user-scalable=no">
  <meta name="description" content="API docs for the sendMergerMessage method from the V2TIMMessageManager class, for the Dart programming language.">
  <title>sendMergerMessage method - V2TIMMessageManager class - v2_tim_message_manager library - Dart API</title>


  
  <link rel="preconnect" href="https://fonts.gstatic.com">
  <link href="https://fonts.googleapis.com/css2?family=Roboto+Mono:ital,wght@0,300;0,400;0,500;0,700;1,400&display=swap" rel="stylesheet">
  <link href="https://fonts.googleapis.com/css2?family=Material+Symbols+Outlined:opsz,wght,FILL,GRAD@24,400,0,0" rel="stylesheet">
  
  <link rel="stylesheet" href="../../static-assets/github.css?v1">
  <link rel="stylesheet" href="../../static-assets/styles.css?v1">
  <link rel="icon" href="../../static-assets/favicon.png?v1">

  
</head>


<body data-base-href="../../" data-using-base-href="false" class="light-theme">

<div id="overlay-under-drawer"></div>

<header id="title">
  <span id="sidenav-left-toggle" class="material-symbols-outlined" role="button" tabindex="0">menu</span>
  <ol class="breadcrumbs gt-separated dark hidden-xs">
    <li><a href="../../index.html">tencent_cloud_chat_sdk</a></li>
    <li><a href="../../manager_v2_tim_message_manager/manager_v2_tim_message_manager-library.html">manager&#47;v2_tim_message_manager.dart</a></li>
    <li><a href="../../manager_v2_tim_message_manager/V2TIMMessageManager-class.html">V2TIMMessageManager</a></li>
    <li class="self-crumb"><span class="deprecated">sendMergerMessage</span> method</li>
  </ol>
  <div class="self-name">sendMergerMessage</div>
  <form class="search navbar-right" role="search">
    <input type="text" id="search-box" autocomplete="off" disabled class="form-control typeahead" placeholder="Loading search...">
  </form>
  <div class="toggle" id="theme-button" title="Toggle brightness">
    <label for="theme">
      <input type="checkbox" id="theme" value="light-theme">
      <span id="dark-theme-button" class="material-symbols-outlined">
        dark_mode
      </span>
      <span id="light-theme-button" class="material-symbols-outlined">
        light_mode
      </span>
    </label>
  </div>
</header>
<main>

<div
    id="dartdoc-main-content"
    class="main-content"
    data-above-sidebar="manager_v2_tim_message_manager&#47;V2TIMMessageManager-class-sidebar.html"
    data-below-sidebar="">
    <div>
<h1><span class="kind-method">sendMergerMessage</span> method 
</h1></div>

    <section class="multi-line-signature">
      
  <div>
    <ol class="annotation-list">
        <li>@<a href="https://api.flutter.dev/flutter/dart-core/Deprecated-class.html">Deprecated</a>(&#39;sendMergerMessage自3.6.0开始弃用，我们将创建消息与发送消息分离，请先使用createMergerMessage创建消息,再调用sendMessage发送消息&#39;)</li>
    </ol>
  </div>

<span class="returntype"><a href="https://api.flutter.dev/flutter/dart-async/Future-class.html">Future</a><span class="signature">&lt;<wbr><span class="type-parameter"><a href="../../models_v2_tim_value_callback/V2TimValueCallback-class.html">V2TimValueCallback</a><span class="signature">&lt;<wbr><span class="type-parameter"><a href="../../models_v2_tim_message/V2TimMessage-class.html">V2TimMessage</a></span>&gt;</span></span>&gt;</span></span>
<span class="name deprecated">sendMergerMessage</span>(<wbr><ol class="parameter-list"><li><span class="parameter" id="sendMergerMessage-param-msgIDList">{<span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/List-class.html">List</a><span class="signature">&lt;<wbr><span class="type-parameter"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span>&gt;</span></span> <span class="parameter-name">msgIDList</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-title"><span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span> <span class="parameter-name">title</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-abstractList"><span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/List-class.html">List</a><span class="signature">&lt;<wbr><span class="type-parameter"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span>&gt;</span></span> <span class="parameter-name">abstractList</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-compatibleText"><span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span> <span class="parameter-name">compatibleText</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-receiver"><span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span> <span class="parameter-name">receiver</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-groupID"><span>required</span> <span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span> <span class="parameter-name">groupID</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-priority"><span class="type-annotation"><a href="../../enum_message_priority_enum/MessagePriorityEnum.html">MessagePriorityEnum</a>?</span> <span class="parameter-name">priority</span> = <span class="default-value">MessagePriorityEnum.V2TIM_PRIORITY_NORMAL</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-onlineUserOnly"><span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/bool-class.html">bool</a></span> <span class="parameter-name">onlineUserOnly</span> = <span class="default-value">false</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-isExcludedFromUnreadCount"><span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/bool-class.html">bool</a></span> <span class="parameter-name">isExcludedFromUnreadCount</span> = <span class="default-value">false</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-offlinePushInfo"><span class="type-annotation"><a href="../../enum_offlinePushInfo/OfflinePushInfo-class.html">OfflinePushInfo</a>?</span> <span class="parameter-name">offlinePushInfo</span>, </span></li>
<li><span class="parameter" id="sendMergerMessage-param-webMessageInstanceList"><span class="type-annotation"><a href="https://api.flutter.dev/flutter/dart-core/List-class.html">List</a><span class="signature">&lt;<wbr><span class="type-parameter"><a href="https://api.flutter.dev/flutter/dart-core/String-class.html">String</a></span>&gt;</span>?</span> <span class="parameter-name">webMessageInstanceList</span>}</span></li>
</ol>)

      

    </section>
    
<section class="desc markdown">
  <p>合并消息</p>
<p>我们在收到一条合并消息的时候，通常会在聊天界面这样显示：</p>
<p>|vinson 和 lynx 的聊天记录 | – title （标题）</p>
<p>|vinson：新版本 SDK 计划什么时候上线呢？ | – abstract1 （摘要信息1）</p>
<p>|lynx：计划下周一，具体时间要看下这两天的系统测试情况.. | – abstract2 （摘要信息2）</p>
<p>|vinson：好的. | – abstract3 （摘要信息3）</p>
<p>聊天界面通常只会展示合并消息的标题和摘要信息，完整的转发消息列表，需要用户主动点击转发消息 UI 后再获取。</p>
<p>多条被转发的消息可以被创建成一条合并消息 V2TIMMessage，然后调用 sendMessage 接口发送，实现步骤如下：</p>
<ol>
<li>
<p>调用 createMergerMessage 创建一条合并消息 V2TIMMessage。</p>
</li>
<li>
<p>调用 sendMessage 发送转发消息 V2TIMMessage。</p>
</li>
</ol>
<p>收到合并消息解析步骤：</p>
<ol>
<li>
<p>通过 V2TIMMessage 获取 mergerElem。</p>
</li>
<li>
<p>通过 mergerElem 获取 title 和 abstractList UI 展示。</p>
</li>
<li>
<p>当用户点击摘要信息 UI 的时候，调用 downloadMessageList 接口获取转发消息列表。</p>
</li>
</ol>
<pre class="language-dart"><code>注意
web 端使用时必须传入webMessageInstanceList 字段。 在web端返回的消息实例会包含该字段
</code></pre>
</section>


    
<section class="summary source-code" id="source">
  <h2><span>Implementation</span></h2>
  <pre class="language-dart"><code class="language-dart">@Deprecated(
    &#39;sendMergerMessage自3.6.0开始弃用，我们将创建消息与发送消息分离，请先使用createMergerMessage创建消息,再调用sendMessage发送消息&#39;)
Future&lt;V2TimValueCallback&lt;V2TimMessage&gt;&gt; sendMergerMessage(
    {required List&lt;String&gt; msgIDList,
    required String title,
    required List&lt;String&gt; abstractList,
    required String compatibleText,
    required String receiver,
    required String groupID,
    MessagePriorityEnum? priority = MessagePriorityEnum.V2TIM_PRIORITY_NORMAL,
    bool onlineUserOnly = false,
    bool isExcludedFromUnreadCount = false,
    OfflinePushInfo? offlinePushInfo,
    List&lt;String&gt;? webMessageInstanceList}) async {
      if (kIsWeb) {
        return await TencentCloudChatSdkPlatform.instance.sendMergerMessage(
            msgIDList: msgIDList,
            title: title,
            abstractList: abstractList,
            compatibleText: compatibleText,
            receiver: receiver,
            groupID: groupID,
            priority: priority!.index,
            onlineUserOnly: onlineUserOnly,
            isExcludedFromUnreadCount: isExcludedFromUnreadCount,
            offlinePushInfo: offlinePushInfo?.toJson(),
            webMessageInstanceList: webMessageInstanceList);
      }

    var result = await TIMMessageManager.instance.createMergerMessage(
      msgIDList: msgIDList,
      title: title,
      abstractList: abstractList,
      compatibleText: compatibleText
    );

    return await TIMMessageManager.instance.sendMessage(
      id: result.data?.id ?? &#39;&#39;,
      receiver: receiver,
      groupID: groupID,
      priority: priority!.index,
      onlineUserOnly: onlineUserOnly,
      isExcludedFromUnreadCount: isExcludedFromUnreadCount,
      offlinePushInfo: offlinePushInfo,
    );
}</code></pre>
</section>


  </div> <!-- /.main-content -->

  <div id="dartdoc-sidebar-left" class="sidebar sidebar-offcanvas-left">
    <!-- The search input and breadcrumbs below are only responsively visible at low resolutions. -->
<header id="header-search-sidebar" class="hidden-l">
  <form class="search-sidebar" role="search">
    <input type="text" id="search-sidebar" autocomplete="off" disabled class="form-control typeahead" placeholder="Loading search...">
  </form>
</header>

<ol class="breadcrumbs gt-separated dark hidden-l" id="sidebar-nav">
    <li><a href="../../index.html">tencent_cloud_chat_sdk</a></li>
    <li><a href="../../manager_v2_tim_message_manager/manager_v2_tim_message_manager-library.html">v2_tim_message_manager</a></li>
    <li><a href="../../manager_v2_tim_message_manager/V2TIMMessageManager-class.html">V2TIMMessageManager</a></li>
    <li class="self-crumb"><span class="deprecated">sendMergerMessage</span> method</li>
</ol>


    <h5>V2TIMMessageManager class</h5>
    <div id="dartdoc-sidebar-left-content"></div>
  </div><!--/.sidebar-offcanvas-->

  <div id="dartdoc-sidebar-right" class="sidebar sidebar-offcanvas-right">
</div><!--/.sidebar-offcanvas-->

</main>

<footer>
  <span class="no-break">
    tencent_cloud_chat_sdk
      8.5.6864-beta.7
  </span>

  
</footer>



<script src="../../static-assets/highlight.pack.js?v1"></script>
<script src="../../static-assets/docs.dart.js"></script>



</body>

</html>

